R Markdown es una herramienta poderosa para crear documentos dinámicos. Una tarea común es incluir y ajustar imágenes. Esta guía te mostrará las mejores formas de hacerlo, desde la sintaxis básica hasta el control total usando chunks de R.
La forma más simple de incluir una imagen es con la sintaxis estándar de Markdown. Es rápida y fácil, pero ofrece muy poco control sobre el resultado final.
Limitación principal: Con este método no puedes cambiar el tamaño, la alineación o añadir un pie de foto numerado de forma nativa.
Para un control total, la mejor práctica es usar un chunk de código de R con la función knitr::include_graphics(). Esto te permite usar las opciones del chunk para modificar casi cualquier aspecto de la imagen.
¡Recuerda! Para que solo se muestre la imagen y no el código, siempre añade la opción echo=FALSE al encabezado del chunk.
Las opciones más comunes son out.width y out.height. Puedes usar porcentajes o píxel.
Este código mostrará la imagen a la mitad del ancho del contenedor del documento. También puedes usar valores fijos como “300px”.
Usa la opción fig.align para alinear la imagen. Los valores posibles son ‘left’, ‘center’, y ‘right’.
Usa fig.cap para añadir un pie de foto descriptivo. R Markdown automáticamente numerará tus figuras (Ej: “Figura 1: …”).
Gato marciano enojado captado en camara.
El texto alternativo es leído por lectores de pantalla. Es fundamental para la accesibilidad. Usa la opción fig.alt.
Aquí tienes un ejemplo que combina todas las opciones más importantes en un solo chunk.
Imagen de pinterest usado como ejemplo.